home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / OpenBSD / INSTALL.amiga < prev    next >
Text File  |  1997-06-08  |  45KB  |  1,111 lines
  1. INSTALLATION NOTES for OpenBSD/amiga 2.1
  2.  
  3.  
  4. What is OpenBSD?
  5. ----------------
  6.  
  7. OpenBSD is a Berkeley Networking Release 2 (Net/2) and 4.4BSD-Lite
  8. -derived Operating System.  It is a fully functional UN*X-like system
  9. which runs on many architectures and is being ported to more.
  10.  
  11. Continuing the multi-platform tradition, OpenBSD has added ports to
  12. mvme68k, powerpc and arc machines.  Kernel interfaces have continued
  13. to be refined, and now several subsystems and device drivers are
  14. shared among the different ports.  You can look for this trend to
  15. continue.
  16.  
  17. Security of the system as a whole has been significantly improved.
  18. Source code for all critical system components has been checked for
  19. remote-access, local-access, denial-of-service, data destruction, or
  20. information-gathering problems.  Tools like ipf, ipnat, and nc have
  21. been added to the tree because security conscious people often need
  22. them.
  23.  
  24. OpenBSD 2.1 has significantly enhanced the binary emulation subsystem
  25. (which includes iBCS2, Linux, OSF/1, SunOS, SVR4, Solaris and Ultrix
  26. compatibility) and several kernel subsystems have been generalized to
  27. support this more readily.  The binary emulation strategy is aimed at
  28. making the emulation as accurate as possible.
  29.  
  30. Cryptography components are part of OpenBSD.  OpenBSD is from Canada,
  31. and export of these pieces (such as kerberosIV) to the world is not
  32. restricted.  Note that it can not be re-exported from the US once it
  33. has entered US.  Because of this, take care NOT to get the distrib-
  34. ution from an FTP server in the US if you are outside of Canada and
  35. the US.
  36.  
  37. Many new user programs have been added in OpenBSD 2.1, as well,
  38. bringing it closer to our goal of supplying a complete and modern
  39. UN*X-like environment.  Tools like perl and ksh are standard, as are
  40. numerous other useful tools.
  41.  
  42.  
  43. This is the second public release of OpenBSD for the Amiga line of
  44. computers.  Several graphics, SCSI and network boards are supported.
  45.  
  46.  
  47. Sources of OpenBSD:
  48. -------------------
  49.  
  50. This is a list of currently known ftp servers:
  51.  
  52. Germany:
  53.  
  54. ftp://ftp.fu-berlin.de/pub/unix/openbsd/mirrors/OpenBSD ==
  55.     ftp://ftp.de.openbsd.org/pub/unix/openbsd/mirrors/OpenBSD
  56.  
  57. Japan:
  58.  
  59. ftp://ftp.tut.ac.jp/OpenBSD == ftp://ftp.jp.openbsd.org/OpenBSD
  60.  
  61. ftp://ftp.dti.ad.jp/pub/OpenBSD
  62.  
  63. Switzerland:
  64.  
  65. ftp://ftp.openbsd.org/pub/OpenBSD == 
  66.     ftp://ftp.eu.openbsd.org/pub/OpenBSD
  67.  
  68. USA:
  69.  
  70. ftp://hydra.heuris.com/pub/OpenBSD ==
  71.     ftp://ftp1.usa.openbsd.org/pub/OpenBSD
  72.  
  73. ftp://freestuff.cs.colorado.edu/pub/OpenBSD == 
  74.     ftp://ftp2.usa.openbsd.org/pub/OpenBSD
  75.  
  76. ftp://ftp.ctaz.com/pub/OpenBSD ==
  77.     ftp://ftp5.usa.openbsd.org/pub/OpenBSD
  78.  
  79. ftp://pub.seastrom.com/pub/OpenBSD ==
  80.     ftp://ftp1.usa.openbsd.org/pub/OpenBSD</a><br>
  81.  
  82.  
  83. As well, the file ftp://ftp.openbsd.org/pub/OpenBSD/2.1/ftplist
  84. contains a list which is continually updated.  If you wish to become a
  85. distribution site for OpenBSD, contact deraadt@cvs.openbsd.org.
  86.  
  87.  
  88. OpenBSD 2.1 Release Contents:
  89. -----------------------------
  90.  
  91. The OpenBSD 2.1 release is organized in the following way.  In the
  92. .../2.1 directory, there is one sub-directory per architecture, for
  93. each of the architectures that OpenBSD 2.1 has a binary distribution
  94. for.  That is described further along in this document).
  95.  
  96. The amiga-specific portion of the OpenBSD 2.1 release is found in the
  97. "amiga" subdirectory of the distribution.  That subdirectory is layed
  98. out as follows:
  99.  
  100. .../2.1/amiga/
  101.         INSTALL.amiga    This file.
  102.  
  103.         CKSUM        Output of the cksum(1) and md5(1) programs
  104.         MD5        usable for verification of the correctness
  105.                 of downloaded files.
  106.  
  107.         X11/        The X window system for OpenBSD/amiga 2.1
  108.  
  109.         bsd        A generic OpenBSD kernel used both for
  110.                 miniroot installation and as the first
  111.                 "real" kernel your OpenBSD installation
  112.                 will use.
  113.  
  114.         bsd.rd        A ramdisk OpenBSD kernel used for simple
  115.                 installation.
  116.  
  117.         miniroot21.fs    A miniroot filesystem image to be used
  118.                 if you for some reason can't or don't
  119.                 want to use the ramdisk installation
  120.                 method.
  121.  
  122.         *.tar.gz    amiga binary distribution sets;
  123.                 see below.
  124.  
  125.         utils/        Miscellaneous amiga installation
  126.                 utilities; see installation section, below.
  127.  
  128. Installation/upgrade miniroot file system:
  129.  
  130.     This file contains a BSD root file system setup to help
  131.     you install or upgrade the rest of OpenBSD.  This includes
  132.     formatting root and /usr partitions in the case of an install
  133.     or converting existing ones if doing an upgrade (this conversion
  134.     is only needed if you are coming from a real old NetBSD world),
  135.     then mounting your root and /usr partitions and getting
  136.     ready to extract (and possibly first fetching) the distribution
  137.     sets.  There is enough on this file system to allow you to
  138.     make a slip or ppp connection, configure an ethernet, mount an
  139.     NFS file system or ftp.  You can also load distribution sets from
  140.     a SCSI tape or from one of your existing AmigaDOS partitions.
  141.  
  142.     This file is named "miniroot21.fs".
  143.  
  144.  
  145. The OpenBSD/amiga binary distribution sets contain the binaries which
  146. comprise the OpenBSD 2.1 release for the amiga.  There are seven binary
  147. distribution sets.  The binary distribution sets can be found in
  148. subdirectories of the "amiga/" subdirectory of the OpenBSD 2.1
  149. distribution tree, and are as follows (all have ".tar.gz" appended to
  150. the name given in the table below):
  151.  
  152.     base21    The OpenBSD/amiga 2.1 base binary distribution.  You
  153.         MUST install this distribution set.  It contains the
  154.         base OpenBSD utilities that are necessary for the
  155.         system to run and be minimally functional.  It
  156.         includes shared library support, and excludes
  157.         everything described below.
  158.         [ 12M gzipped, 36M uncompressed ]
  159.  
  160.     comp21    The OpenBSD/amiga Compiler tools.  The C, C++, and
  161.         FORTRAN language environments are supported.  This set
  162.         includes the system include files (/usr/include), the
  163.         linker, the compiler tool chain, and the various system
  164.         libraries (except the shared libraries, which are
  165.         included as part of the base set).  This set also
  166.         includes the manual pages for all of the utilities it
  167.         contains, as well as the system call and library manual
  168.         pages.
  169.         [ 7M gzipped, 24M uncompressed ]
  170.  
  171.     etc21    This distribution set contains the system configuration
  172.         files that reside in /etc and in several other places.
  173.         This set MUST be installed if you are installing the
  174.         system from scratch, but should NOT be used if you are
  175.         upgrading.  (If you are upgrading, it's recommended that
  176.         you get a copy of this set and CAREFULLY upgrade your
  177.         configuration files by hand.)
  178.         [ 90K gzipped, 450K uncompressed ]
  179.  
  180.     game21    This set includes the games and their manual pages.
  181.         [ 3M gzipped, 7M uncompressed ]
  182.  
  183.     man21    This set includes all of the manual pages for the
  184.         binaries and other software contained in the base set.
  185.         Note that it does not include any of the manual pages
  186.         that are included in the other sets.
  187.         [ 2M gzipped, 9M uncompressed ]
  188.  
  189.     misc21    This set includes the system dictionaries (which are
  190.         rather large), the typesettable document set, and
  191.         man pages for other architectures which happen to be
  192.         installed from the source tree by default.
  193.         [ 2M gzipped, 6M uncompressed ]
  194.  
  195.     text21    This set includes OpenBSD's text processing tools,
  196.         including groff, all related programs, and their
  197.         manual pages.
  198.         [ 1M gzipped, 4M uncompressed ]
  199.  
  200.  
  201. OpenBSD System Requirements and Supported Devices:
  202. --------------------------------------------------
  203.  
  204. OpenBSD/amiga 2.1 runs on any amiga that has a 68020, 68030, 68040 or
  205. 68060 CPU with some form of FPU and MMU.  It should also run on
  206. MacroSystem's DraCo computer.  The minimal configuration requires 4M of
  207. RAM and about 55M of disk space.  To install the entire system requires
  208. much more disk space, and to run X or compile the system, more RAM is
  209. recommended.  (4M of RAM will actually allow you to compile, however it
  210. won't be speedy.  X really isn't usable on a 4M system.)
  211.  
  212. Here is a table of recommended HD partition sizes for a full install:
  213.     partition:    advise,    with X,    needed,    with X
  214.     root (/)    20M    20M    15M    15M
  215.     user (/usr)    95M    130M    75M     110M
  216.     swap        ---- 1MB for every MB RAM ----
  217.             -- but the sum of swap and ---
  218.             - RAM should be at least 16 --
  219.  
  220. As you may note the recommended size of /usr is 20M greater than
  221. needed. This is to leave room for a kernel source and compile tree
  222. as you will probably want to compile your own kernel. (GENERIC is
  223. large and bulky to accommodate all people).
  224.  
  225. If you only have 4M of fast memory, you should make your swap partition
  226. larger, as your system will be doing much more swapping.
  227.  
  228. Supported devices include:
  229.     A4000/A1200 IDE controller.
  230.     ISA IDE & ATAPI with a supported ISA bridge.
  231.     SCSI host adapters:
  232.         33c93 based boards: A2091, A3000 and GVP series II.
  233.         53c80 based boards: 12 Gauge, IVS, Emplant and
  234.                     Wordsync/Bytesync.
  235.         53c710 based boards: A4091, Magnum, Warp Engine, Zeus
  236.                      and DraCo.
  237.         FAS216 based boards: FastLane Z3, Blizzard.
  238.     Video controllers:
  239.         ECS, AGA and A2024 built in on various amigas
  240.         Retina Z2 and Retina Z3.
  241.         Picasso II.
  242.         GVP Spectrum.
  243.         Piccolo.
  244.         A2410.
  245.         Cybervision 64.
  246.         oMnibus.
  247.         Domino.
  248.         Merlin.
  249.     Ethernet controllers:
  250.         A2065.
  251.         Hydra.
  252.         ASDG.
  253.         A4066.
  254.         Ariadne.
  255.         Quicknet.
  256.         Via a supported ISA bridge:
  257.             NE[12]000, SMC/WD 8003/8013/8216 and 3COM 3c503.
  258.         
  259.     Arcnet controllers:
  260.         A2060.
  261.     Tape drives:
  262.         Most SCSI tape drives.
  263.     CD-ROM drives:
  264.         Most SCSI CD-ROM drives.
  265.     Serial ports:
  266.         Amiga serial port.
  267.         DraCo serial port.
  268.         MultiFaceCard II and III.
  269.         A2232.
  270.         PC COM ports attached to a supported ISA bridge.
  271.     Parallel ports:
  272.         Amiga parallel port.
  273.         PC LPT ports attached to a supported ISA bridge.
  274.     ISA bridges:
  275.         The GoldenGate Bus+ (aka GG2).
  276.         The CrossLink.
  277.     Amiga floppy drives.
  278.     Amiga mouse.
  279.  
  280. If its not on this list, there is no support for it in this release.
  281.  
  282.  
  283. Getting the OpenBSD System onto Useful Media:
  284. ---------------------------------------------
  285.  
  286. Installation is supported from several media types, including:
  287.  
  288.     AmigaDOS partitions
  289.     FFS partitions
  290.     Tape
  291.     Remote NFS partition
  292.     FTP
  293.     HTTP
  294.  
  295. The installation program is run under a minimal OpenBSD environment
  296. provided by one of two means: a ramdisk or a miniroot filesystem.
  297. We recommend using the ramdisk if your machine is big enough (at
  298. least 6MB of fastmem is required), otherwise a miniroot filesystem
  299. needs to be transferred to the OpenBSD swap partition.  This can be
  300. done from AmigaDOS in the case of a new install or upgrade, or from
  301. OpenBSD when doing an upgrade.  See the "Preparing your System for
  302. OpenBSD Installation" section for details.
  303.  
  304. The steps necessary to prepare the distribution sets for
  305. installation depend on which method of installation you choose.
  306. The various methods are explained below.  However, for all methods
  307. you need to transfer a OpenBSD kernel binary to your AmigaDOS
  308. partition, optionally you must also get the miniroot image there
  309. for later transfer to your swap partition as explained elsewhere.
  310. For ramdisk installs you need to get both the bsd and bsd.rd
  311. kernel images, and for miniroot installs you need bsd and the
  312. miniroot21.fs image.
  313.  
  314. To prepare for installing via an AmigaDOS partition:
  315.  
  316.     To install OpenBSD from an AmigaDOS partition, you need to
  317.     get the OpenBSD distribution sets you wish to install
  318.     on your system on to an AmigaDOS partition.  All of the
  319.     set_name.tar.gz pieces can be placed in a single directory
  320.     instead of separate ones for each distribution set.  This
  321.     will also simplify the installation work later on.
  322.  
  323.     Note where you place the files, you will need this later.
  324.     Also, it might be a good idea to type down the AmigaDOS
  325.     partition structure of the disk you put these files on.  In
  326.     the context of the install program you will only be able to
  327.     identify the partition by starting sector (block) number
  328.     and/or size.  The partition names are *not* available.
  329.  
  330.     Once you have done this, you can proceed to the next
  331.     step in the installation process, preparing your hard disk.
  332.  
  333. To prepare for installing via a tape:
  334.  
  335.     To install OpenBSD from a tape, you need to somehow
  336.     get the OpenBSD filesets you wish to install on
  337.     your system on to the appropriate kind of tape,
  338.     in tar format.
  339.  
  340.     If you're making the tape on a UN*X system, the easiest
  341.     way to do so is:
  342.  
  343.         tar cvf <tape_device> <files>
  344.  
  345.     where "<tape_device>" is the name of the tape device
  346.     that describes the tape drive you're using (possibly
  347.     something like /dev/nrst0, but we make no guarantees 8-).
  348.     If you can't figure it out, ask your system administrator.
  349.     "<files>" are the names of the "set_name.tar.gz" files
  350.     which you want to be placed on the tape.
  351.  
  352.     Once you have done this, you can proceed to the next
  353.     step in the installation process, preparing your hard disk.
  354.  
  355. To prepare for installing via NFS:
  356.  
  357.     Place the OpenBSD software you wish to install into
  358.     a directory on an NFS server, and make that directory
  359.     mountable by the machine which you will be installing
  360.     OpenBSD on.  This will probably require modifying the
  361.     /etc/exports file of the NFS server and resetting
  362.     mountd, acts which will require superuser privileges.
  363.     Note the numeric IP address of the NFS server and of
  364.     the router closest to the the new OpenBSD machine,
  365.     if the NFS server is not on a network which is
  366.     directly attached to the OpenBSD machine.
  367.  
  368.     Once you have done this, you can proceed to the next
  369.     step in the installation process, preparing your hard disk.
  370.  
  371. To prepare for installing via FTP/HTTP:
  372.  
  373.     The preparations for this method of installation
  374.     are easy: all you have to do is make sure that
  375.     there's some FTP- or website from which you can
  376.     retrieve the OpenBSD installation when it's time to
  377.     do the install.  You should know the numeric IP
  378.     address of that site, and the numeric IP address of
  379.     your nearest router if one is necessary
  380.  
  381.     Once you have done this, you can proceed to the next
  382.     step in the installation process, preparing your hard disk.
  383.  
  384. If you are upgrading OpenBSD, you also have the option of installing
  385. OpenBSD by putting the new distribution sets somewhere in your existing
  386. file system, and using them from there.  To do that, you must do the
  387. following:
  388.  
  389.     Place the distribution sets you wish to upgrade somewhere in
  390.     your current file system tree.  At a bare minimum, you must
  391.     upgrade the "base" binary distribution, and so must put the
  392.     "base21.tar.gz" set somewhere in your file system.  If you wish,
  393.     you can do the other sets, as well, but you should NOT upgrade
  394.     the "etc" distribution; the "etc" distribution contains system
  395.     configuration files that you should review and update by hand.
  396.  
  397.     Once you have done this, you can proceed to the next step in
  398.     the upgrade process, actually upgrading your system.
  399.  
  400.  
  401. Preparing your System for OpenBSD Installation:
  402. -----------------------------------------------
  403.  
  404. You will need an AmigaDOS hard drive prep tool to prepare you hard
  405. drives for use with OpenBSD/amiga.  HDToolBox is provided with the
  406. system software and on floppy installation disks since Release 2.0
  407. of AmigaDOS so we will provide instructions for its use.
  408.  
  409. Preparing you hard disk with HDToolBox:
  410.  
  411.     A full explanation of HDToolBox can be found with your
  412.     AmigaDOS manuals and is beyond the scope of this document.
  413.  
  414.     Note you will be modifying your HD's if you mess something 
  415.     up here you could lose everything on all the drives that 
  416.     you configure.  It is therefore advised that you:
  417.  
  418.         Write down your current configurations.  Do this
  419.         by examining each partition on the drive and the
  420.         drives parameters (from Change drive type.)
  421.  
  422.         Back up the partitions you are keeping.
  423.  
  424.     What you need to do is partition your drives; creating at least
  425.     root, swap and /usr partitions and possibly some more for
  426.     /tmp, /var, /home or others of your own choice.  (The root and
  427.     swap partitions must be on the same drive for your initial
  428.     installation. You can use other configurations after building a
  429.     customized kernel once your system is running.)  Partitioning is
  430.     traditionally an area of great confusion and disagreement, and
  431.     religion plays a large role in most advice you'll get.  The
  432.     author of this paragraph is a fan of large and few partitions,
  433.     normally one per disk, unless it's the root disk, where I tend
  434.     to have /, swap, /tmp, /var & /usr.  I must admit that I step
  435.     aside from my normal rules of thumb very often due to the context
  436.     the machine will work in.
  437.  
  438.     This should be done as the HDToolBox manual describes.  One thing
  439.     to note is that if you are not using a Commodore controller you
  440.     will need to specify the device your SCSI controller uses e.g.
  441.     if you have a Warp Engine you would:
  442.  
  443.         from cli,
  444.             hdtoolbox warpdrive.device
  445.  
  446.         from wb set the tooltype,
  447.             SCSI_DEVICE_NAME=warpdrive.device
  448.  
  449.     The important things you need to do above and beyond normal
  450.     partitioning includes (from Partition Drive section):
  451.  
  452.         Marking all OpenBSD partitions as non-bootable.
  453.  
  454.         Changing the file system parameters of the partitions
  455.         to OpenBSD ones.  This must be done from the
  456.         partitioning section and `Advanced options' must
  457.         be enabled.  To Make the needed changes:
  458.  
  459.         - Click the `Adv. Options' button
  460.         - Click the `Change filesystem' button
  461.  
  462.         - Choose `Custom File System'
  463.         - Turn off `Automount' if on.
  464.         - Set the dostype to one of these three choices:
  465.  
  466.             root partition  : 0x4e425207
  467.             swap partition  : 0x4e425301
  468.             other partitions: 0x4e425507
  469.  
  470.         Here `other' refers to other partitions you will
  471.         format for reading and writing under OpenBSD (e.g.
  472.         /usr)
  473.  
  474.         Make sure you hit the return key to enter this value
  475.         as some versions of HDToolBox will forget your entry
  476.         if you don't.
  477.  
  478.         - Turn custom boot code off
  479.         - Set Reserved Blocks start and end to 0.
  480.         - Click Ok.
  481.  
  482.         Mask and maxtransfer are not used with OpenBSD.
  483.  
  484.         Until you compile your own kernel your swap partition
  485.         must exist on the drive that also holds your root
  486.         partition.
  487.  
  488.     
  489.     Once this is done OpenBSD/amiga will be able to recognize your
  490.     disks and which partitions it should use.
  491.  
  492. Choosing installation root filesystem type:
  493.  
  494.     The OpenBSD/amiga operating system can be installed using two
  495.     different root filesystems: ramdisk or miniroot.  The ramdisk
  496.     is strongly recommended as it requires less preparation work.
  497.     However the ramdisk kernel requires that your system has at
  498.     least 6MB of fastmem.  The miniroot requires less (installs on
  499.     a 4MB system should be possible) and has tools to make SLIP or
  500.     PPP connections, which the ramdisk doesn't, however you need
  501.     to be an experienced user to make use of these as the install
  502.     scripts doesn't deal with them.  Furthermore the miniroot
  503.     install requires you to do the preparation described in the
  504.     following paragraph.  To use the ramdisk install you should get
  505.     the bsd.rd kernel as well as the standard bsd one, and *do*
  506.     skip the next section!
  507.  
  508. Transferring the miniroot filesystem:
  509.  
  510.     The OpenBSD/amiga installation or upgrade can use a "miniroot"
  511.     fileystem which is installed on the partition used by OpenBSD
  512.     for swapping.
  513.  
  514.     Once the hard disk has been prepared for OpenBSD, the miniroot
  515.     filesystem (miniroot21.fs) is transferred to the swap partition
  516.     configured during the hard disk prep (or the existing swap
  517.     partition in the case of an upgrade).  The xstreamtodev utility
  518.     provided in the "amiga/utilities" directory can be used on
  519.     AmigaDOS to transfer the filesystem for either a new installation
  520.     or an upgrade.  The filesystem can also be transferred on an
  521.     existing OpenBSD (or NetBSD) system for an update by using dd.
  522.     This should only be done after booting the former OS into single-
  523.     user state.  It may also be possible to shutdown to single-user,
  524.     providing that the single-user state processes are not using the
  525.     swap partition.
  526.  
  527.     On AmigaDOS, the command:
  528.         xstreamtodev --input=miniroot21.fs --rdb-name=<swap partition>
  529.     where <swap partition> is the name you gave to the OpenBSD
  530.     partition to be used for swapping.  If xstreamtodev is unable to
  531.     determine the SCSI driver device name or the unit number of the
  532.     specified partition, you may also need to include the option
  533.     "--device=<driver.name>" and/or "--unit=<SCSI unit number>".
  534.  
  535.     To transfer the miniroot using an older BSD, you should be booted
  536.     up in single user state on the current system, or use the
  537.     "shutdown now" command to shutdown to single-uyser state.  Then
  538.     copy the miniroot using dd:
  539.         dd if=miniroot21.fs of=/dev/rsdXb
  540.     where /dev/rsdXb should be the device path of the swap partition
  541.     your system is configured to use.  Once the file is copied,
  542.     reboot back to AmigaDOS to boot the new OpenBSD kernel.  NOTE:
  543.     the release kernel is a "generic" kernel, and requires that the
  544.     swap partition be on the same device as the root partition.
  545.  
  546.  
  547. Installing the OpenBSD System:
  548. ------------------------------
  549.  
  550. Installing OpenBSD is a relatively complex process, but, if you have
  551. this document in hand and are careful to read and remember the
  552. information which is presented to you by the install program, it
  553. shouldn't be too much trouble.
  554.  
  555. Before you begin, you must have already prepared your hard disk as
  556. detailed in the section on preparing your system for install.
  557.  
  558. The following is a walk-through of the steps necessary to get OpenBSD
  559. installed on your hard disk.  If you wish to stop the installation,
  560. you may hit Control-C at any prompt, but if you do, you'll have to
  561. begin again from scratch.
  562.  
  563.     If you have a small machine (less than 6MB of fast RAM) you'll
  564.     have to setup a miniroot filesystem in the swap partition, as
  565.     described in the "Preparing your System for OpenBSD Installation"
  566.     section above.  If your machine has 6MB or more we strongly
  567.     recommend using the ramdisk kernel instead.  This way you don't
  568.     need to setup any root image beforehand.
  569.  
  570.     You then need to have "ixemul.library" in your LIBS: directory
  571.     on AmigaDOS.  You also need to have the "loadbsd" program
  572.     in your command path.  If AmigaDOS complains about loadbsd
  573.     not being an executable file, be sure that the "Execute"
  574.     protection bit is set.  If not, set it with the command:
  575.         Protect loadbsd add e
  576.  
  577.     Next you need to get yourself into OpenBSD by loading the
  578.     kernel from AmigaDOS with loadbsd like so:
  579.  
  580.         loadbsd bsd.rd
  581.  
  582.     or, if you are doing a miniroot install:
  583.  
  584.         loadbsd -b bsd
  585.  
  586.  
  587.     If you have an AGA machine, and your monitor will handle
  588.     the dblNTSC mode, you may also include the "-A" option to
  589.     enable the dblNTSC display mode.
  590.  
  591.     You should see the screen clear and some information about
  592.     your system as the kernel configures the hardware.  Note which
  593.     hard disk device(s) are configured (sd0, sd1, etc).  You will
  594.     be asked for disknames later during the install.  If you cannot
  595.     read the messages as they scroll by, do not worry -- you can get
  596.     at this information later inside the install program.  If you
  597.     are doing the miniroot install you will be prompted for a root
  598.     device.  At this time type 'sd0*', where '0' is the device which
  599.     holds the miniroot-containing swap partition you created during
  600.     the hard disk preparation.  If the system should hang after
  601.     entering the root device, try again with
  602.  
  603.         loadbsd -I ff -b bsd
  604.  
  605.     This disables synchronous transfer on all SCSI devices.  For
  606.     ramdisk installations this kind of hang might occur later during
  607.     the install when accessing the SCSI disk for the first time.  If
  608.     such a hang occurs, try again with:
  609.  
  610.         loadbsd -I ff bsd.rd
  611.  
  612.     While booting, you will probably see several warnings.  You
  613.     should be warned that no swap space is present, and that
  614.     init(8) cannot find /etc/rc.  Do not be alarmed, these are
  615.     completely normal.  When you reach the prompt asking you for a
  616.     shell name, just hit return.
  617.  
  618.     You will be asked which terminal type to use, you should just
  619.     hit return to select the default (vt220).
  620.  
  621.     The install program will then tell you which disks of that
  622.     type it can install on, and ask you which it should use.  The
  623.     name of the disk is typically "sd0" for SCSI drives or the
  624.     A4000 IDE drives or "wd0" for ISA-connected IDE drives.  Reply
  625.     with the name of your disk.
  626.  
  627.     The install program will now ask which file systems should be
  628.     created on which partitions.  It will automatically select the
  629.     'a' partition to be the root file system. Next it will ask for
  630.     which disk and partition you want a file system created on.
  631.     This will be the same as the disk name (eg. "sd0") with the
  632.     letter identifying the partition (eg. "d") appended (eg.
  633.     "sd0d").  Then it will ask where this partition is to be
  634.     mounted, eg. /usr.  This process will be repeated until you
  635.     just hit return.
  636.  
  637.     At this point you will be asked to confirm that the file system
  638.     information you have entered is correct, and given an opportunity
  639.     to change the file system table.  Next it will create the new file
  640.     systems as specified, OVERWRITING ANY EXISTING DATA.  This is the
  641.     point of no return.
  642.  
  643.     The install program will now make the filesystems you specified.
  644.     There should be only one error in this section of the installation.
  645.     It will look like this:
  646.  
  647.         newfs: ioctl (WDINFO): Invalid argument
  648.         newfs: /dev/rsd0a: can't rewrite disk label
  649.  
  650.     If there are any others, restart from the the beginning of
  651.     the installation process.  This error is ok as the Amiga
  652.     does not write disklabels currently.  You should expect
  653.     this error whenever using newfs.
  654.  
  655.     After all your file systems have been created, the install program
  656.     will give you an opportunity to configure the network.  The network
  657.     configuration you enter (if any) can then be used to do the install
  658.     from another system using NFS, HTTP or FTP, and will also be the
  659.     configuration used by the system after the installation is complete.
  660.  
  661.     If you select to configure the network, the install program will
  662.     ask you for a name of your system and the DNS domain name to use.
  663.     Note that the host name should be without the domain part, and that
  664.     the domain name should NOT include the host name part.
  665.  
  666.     Next the system will give you a list of network interfaces you can
  667.     configure.  For each network interface you select to configure, it
  668.     will ask for the IP address to use, the symbolic host name to use,
  669.     the netmask to use and any interface-specific flags to set.  The
  670.     interface-specific flags are usually used to determine which media
  671.     the network card is to use.  The flags usually carry the following
  672.     meaning:
  673.  
  674.         -link0 -link1    Use BNC (coaxial) port [default]
  675.         link0 -link1    Use AUI port
  676.         link0 link1        Use UTP (twisted pair) port
  677.  
  678.     After all network interfaces has been configured the install pro-
  679.     gram will ask for a default route and IP address of the primary
  680.     name server to use.  You will also be presented with an opportunity
  681.     to edit the host table.
  682.  
  683.     At this point you will be allowed to edit the file system table
  684.     that will be used for the remainder of the installation and that
  685.     will be used by the finished system, following which the new file
  686.     systems will be mounted to complete the installation.
  687.  
  688.     After these preparatory steps has been completed, you will be
  689.     able to extract the distribution sets onto your system.  There
  690.     are several install methods supported; FTP, HTTP, tape, CD-ROM, NFS
  691.     or a local disk partition.  To install from a tape, the distrib-
  692.     ution sets must have been written to tape prior to running the
  693.     installation program, either as tar images or as gzipped tar
  694.     images.  Note that installation from floppies are not currently
  695.     supported.
  696.  
  697.     To install via FTP:
  698.         To begin an FTP install you will need the following
  699.         pieces of information.  Don't be daunted by this list;
  700.         the defaults are sufficient for most people.
  701.             1) Proxy server URL if you are using a URL-based
  702.                ftp proxy (squid, CERN ftp, Apache 1.2 or higher).
  703.                You need to define a proxy if you are behind a
  704.                firewall that blocks outgoing ftp (assuming you
  705.                have a proxy available to use).
  706.             2) Do you need to use passive mode ftp?  Most modern
  707.                ftp servers are capable of dealing with passive
  708.                ftp connections.  You only need to enable this
  709.                option if you are behind a firewall that allows
  710.                outgoing ftp but blocks incoming tcp ports > 1023.
  711.                If in doubt say yes to this option.
  712.                Note that you will not be asked about passive
  713.                ftp if you are using a proxy.
  714.             3) The IP address (or hostname if you enabled
  715.                DNS earlier in the install) of an ftp server
  716.                carrying the OpenBSD 2.1 distribution.
  717.                If you don't know, just hit return when
  718.                asked if you want to see a list of such hosts.
  719.             4) The ftp directory holding the distribution sets.
  720.                The default value of pub/OpenBSD/2.1/amiga
  721.                is almost always correct.
  722.             5) The login and password for the ftp account.
  723.                The default will be correct unless you are
  724.                doing non-anonymous ftp.
  725.  
  726.         For instructions on how to complete the installation via
  727.         ftp, see the section named "Common URL installations" below.
  728.  
  729.     To install via HTTP:
  730.         To begin an HTTP install you will need the following
  731.         pieces of information:
  732.             1) Proxy server URL if you are using a URL-based
  733.                http proxy (squid, CERN ftp, Apache 1.2 or higher).
  734.                You need to define a proxy if you are behind a
  735.                firewall that blocks outgoing http connections
  736.                (assuming you have a proxy available to use).
  737.             3) The IP address (or hostname if you enabled
  738.                DNS earlier in the install) of an http server
  739.                carrying the OpenBSD 2.1 distribution.
  740.                If you don't know, just hit return when
  741.                asked if you want to see a list of such hosts.
  742.             4) The directory holding the distribution sets.
  743.                There is no standard location for this;
  744.                You should use the directory specified
  745.                along with the server in the list of official
  746.                http mirror sites that you received in step 3.
  747.  
  748.         For instructions on how to complete the installation via
  749.         http, see the section named "Common URL installations" below.
  750.  
  751.     To install from tape:
  752.         In order to install from tape, the distribution sets to be
  753.         installed must have been written to tape previously, either
  754.         in tar format or gzip-compressed tar format.
  755.  
  756.         You will also have to identify the tape device where the
  757.         distribution sets are to be extracted from.  This will
  758.         typically be "nrst0" (no-rewind, raw interface).
  759.  
  760.         Next you will have to provide the file number of the set
  761.         that is to be extracted.  Note that the file number starts
  762.         at 1, which is the first file written to the tape.
  763.  
  764.         The install program will not automatically detect whether
  765.         an image has been compressed, so it will ask for that
  766.         information before starting the extraction.
  767.  
  768.     To install from CD-ROM:
  769.         When installing from a CD-ROM, you will be asked which
  770.         device holds the distribution sets.  This will typically
  771.         be either "cd0" or "acd0".  Next you will be asked which
  772.         partition on the CD-ROM the distribution is to be loaded
  773.         from.  This is normally partition "a".
  774.  
  775.         Next you will have to identify the file system type that
  776.         has been used to create the distribution on the CD-ROM,
  777.         this can be either FFS or ISO CD9660.  The OpenBSD CD
  778.         distribution uses the CD9660 format.
  779.  
  780.         You will also have to provide the relative path to the
  781.         directory on the CD which holds the distribution, for the
  782.         amiga this is "2.1/amiga".
  783.  
  784.         For instructions on how to complete the installation from
  785.         the CD-ROM distribution, see the section named "Common
  786.         file system installations" below.
  787.         
  788.     To install from a NFS mounted directory:
  789.         When installing from a NFS-mounted directory, you must
  790.         have completed network configuration above, and also
  791.         set up the exported file system on the NFS server in
  792.         advance.
  793.  
  794.         First you must identify the IP address of the NFS server
  795.         to load the distribution from, and the file system the
  796.         server expects you to mount.
  797.  
  798.         The install program will also ask whether or not TCP
  799.         should be used for transport (the default is UDP).  Note
  800.         that TCP only works with newer NFS servers.
  801.  
  802.         You will also have to provide the relative path to the
  803.         directory on the file system where the distribution sets
  804.         are located.  Note that this path should not be prefixed
  805.         with a '/'.
  806.  
  807.         For instructions on how to complete the installation from
  808.         the CD-ROM distribution, see the section named "Common
  809.         file system installations" below.
  810.  
  811.     To install from a local disk partition:
  812.         When installing from a local disk partition, you will
  813.         first have to identify which disk holds the distribution
  814.         sets.  This is normally "sdN" or "wdN" where N is a
  815.         number 0 through 9.  Next you will have to identify the
  816.         partition within that disk that holds the distribution,
  817.         this is a single letter between 'a' and 'p'.
  818.  
  819.         You will also have to identify the type of file system
  820.         residing in the partition identified.  Currently you can
  821.         install from partitions that has been formatted as
  822.         Berkely fast file system (ffs) or AmigaDOS FFS (ados).
  823.  
  824.         You will also have to provide the relative path to the
  825.         directory on the file system where the distribution sets
  826.         are located.  Note that this path should not be prefixed
  827.         with a '/'.
  828.  
  829.         For instructions on how to complete the installation from
  830.         the a local disk partition, see the next section.
  831.         
  832.     Common file system installations:
  833.         The following instructions are common to installations
  834.         from local disk partitions, NFS mounted directories and
  835.         CD-ROMs.
  836.  
  837.         A list of available distribution sets will be listed.  If
  838.         any sets has already been extracted, those will be marked
  839.         with an X.  Enter the name of one distribution set at a
  840.         time, until all desired distribution sets has been
  841.         installed on your system.
  842.  
  843.     Common URL installations:
  844.         Once you have entered the required information, the
  845.         install program will fetch a file list and present
  846.         a list of all the distribution sets that were found
  847.         in the specified directory.  (If no valid sets were found,
  848.         you will be notified and given the option of unpacking
  849.         any gzipped tar files found or getting a file list if
  850.         none were found.)
  851.  
  852.         At this point you may individually select distribution
  853.         sets to install or enter "all" to install all of
  854.         the sets (which is what most users will want to do).
  855.         You may also enter "list" to get a file list or
  856.         "done" when you are done selecting distribution sets.
  857.         (It is also possible to enter an arbitrary filename
  858.         and have it treated as a file set).
  859.  
  860.         Once you have selected the file sets you want to install
  861.         and entered "done" you will be prompted to verify that
  862.         you really do want to download and install the files.
  863.         Assuming you acquiesce, the files will begin to download
  864.         and unpack.  If not, you will be given the option of
  865.         installing sets via one of the other install methods.
  866.  
  867.  
  868.     When all the selected distribution sets has been extracted, you
  869.     will be allowed to select which time zone your system will be
  870.     using, all the device nodes needed by the installed system will
  871.     be created for you and the file systems will be unmounted.  For
  872.     this to work properly, it is expected that you have installed
  873.     at least the "base21" and "etc21" distribution sets.
  874.  
  875.  
  876. Congratulations, you have successfully installed OpenBSD 2.1.  When you
  877. reboot into OpenBSD, you should log in as "root" at the login prompt.
  878. There is no initial password, but if you're using the machine in a
  879. networked environment, you should create yourself an account and
  880. protect it and the "root" account with good passwords.
  881.  
  882. Some of the files in the OpenBSD 2.1 distribution might need to be
  883. tailored for your site.  In particular, the /etc/sendmail.cf file will
  884. almost definitely need to be adjusted, and other files in /etc will
  885. probably need to be modified, as well.  If you are unfamiliar with
  886. UN*X-like system administration, it's recommended that you buy a book
  887. that discusses it.
  888.  
  889.  
  890. Upgrading a previously-installed OpenBSD System:
  891. ------------------------------------------------
  892.  
  893. The upgrade to OpenBSD 2.1 is a binary upgrade; it would be prohibitive
  894. to make users upgrade by compiling and installing the 2.1 sources, and
  895. it would be very difficult to even compile a set of instructions that
  896. allowed them to do so.
  897.  
  898. To do the upgrade, and if you are using the miniroot installation, you
  899. must have the OpenBSD kernel on AmigaDOS and you must transfer the root
  900. filesystem miniroot21.fs onto the swap partition of the OpenBSD hard disk.
  901. If you are using the ramdsik installation, the bsd.rd kernel is enough.
  902. You must also have at least the "base21" binary distribution set available,
  903. so that you can upgrade with it, using one of the upgrade methods described
  904. above.  Finally, you must have sufficient disk space available to install
  905. the new binaries.  Since the old binaries are being overwritten in place,
  906. you only need space for the new binaries, which weren't previously
  907. on the system.  If you have a few megabytes free on each of your
  908. root and /usr partitions, you should have enough space.
  909.  
  910. Since upgrading involves replacing the kernel, and most of the system
  911. binaries, it has the potential to cause data loss.  You are strongly
  912. advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK, whether on the
  913. OpenBSD partition or on another operating system's partition, before
  914. beginning the upgrade process.
  915.  
  916. To upgrade your system, follow the following instructions:
  917.  
  918.     If you know you need an -I option to loadbsd, you should add it
  919.     to the loadbsd invocation you'll use for the upgrade.
  920.  
  921.     Miniroot installation:
  922.  
  923.     Transfer the upgrade miniroot filesystem onto the hard disk
  924.     partition used by OpenBSD for swapping, as described in the
  925.     "Preparing your System for OpenBSD Installation" section above.
  926.  
  927.     Now boot up OpenBSD using the 2.1 kernel using the loadbsd
  928.     command:
  929.  
  930.         loadbsd -b bsd
  931.  
  932.     You should see the screen clear and some information about
  933.     your system as the kernel configures the hardware.  Note which
  934.     hard disk device is configured that contains your root and
  935.     swap partition.  When prompted for the root device, type
  936.     'sd0*' (replacing 0 with the disk number that OpenBSD used for
  937.     your root/swap device).  The '*' character indicates that the
  938.     root filesystem is contained on the swap partition.  Continue
  939.     reading below the ramdisk installation description:
  940.  
  941.     Ramdisk installation:
  942.  
  943.     Now boot up OpenBSD using the 2.1 kernel using the loadbsd
  944.     command:
  945.  
  946.         loadbsd bsd.rd
  947.  
  948.     You should see the screen clear and some information about
  949.     your system as the kernel configures the hardware.
  950.  
  951.     Common instructions for both miniroot/ramdisk installations:
  952.  
  953.     When you reach the prompt asking you for a shell name, just
  954.     hit return.
  955.  
  956.     You will be asked which terminal type to use, you should just
  957.     hit return to select the default (vt220).
  958.  
  959.     At the question whether to (I)nstall or (U)pgrade choose "U".
  960.  
  961.     You will be presented with some information about the upgrade
  962.     process and a warning message, and will be asked if you wish
  963.     to proceed with the upgrade process.  If you answer
  964.     negatively, the upgrade process will stop, and your disk will
  965.     not be modified.  If you answer affirmatively, the upgrade
  966.     process will begin, and your disk will be modified.  You may
  967.     hit Control-C to stop the upgrade process at any time.
  968.     However, if you hit it at an inopportune moment, your system
  969.     may be left in an inconsistent (and possibly unusable) state.
  970.  
  971.     The upgrade program will then chack & mount your root filesystem
  972.     under /mnt and grab some configuration info from it for the
  973.     continued upgrade process.  You'll be asked if the network
  974.     should be enabled at this point.  After that is done the rest
  975.     of the filesystems will be checked and mounted.
  976.  
  977.     If you don't already have the OpenBSD distribution sets on your
  978.     disk, look in the installation section for information on how
  979.     to transfer them to your disk.
  980.  
  981.     Once the distribution sets are transferred to your disk,
  982.     continue here.  (Obviously, if the OpenBSD distribution sets
  983.     are already on your disk, because you've transferred them
  984.     before starting the upgrade process, you don't need to
  985.     transfer them again now!)
  986.  
  987.     After the software has been transferred to the machine (or
  988.     mounted, in the case of upgrading via NFS).
  989.  
  990. Your system has now been upgraded to OpenBSD 2.1.
  991.  
  992.     After all this, your machine is a complete OpenBSD 2.1 system.
  993.     However, that doesn't mean that you're finished with the upgrade
  994.     process.  There are several things that you should do, or might
  995.     have to do, to insure that the system works properly.
  996.  
  997.     First, you will probably want to get the etc21.tar.gz distribution,
  998.     extract it, and compare its contents with those in your /etc/
  999.     directory.  You will probably want to replace some of your
  1000.     system configuration files, or incorporate some of the changes
  1001.     in the new versions into yours.
  1002.  
  1003.     Second, you might want to check your /dev against the new MAKEDEV
  1004.     script found there, if you have changed the nodes locally.  The
  1005.     upgrade process runs "sh MAKEDEV all" but that may not be enough
  1006.     for your personal setup.
  1007.  
  1008.     Third, you must deal with certain changes in the formats of
  1009.     some of the configuration files.  The most notable change is
  1010.     that the "options" given to many of the file systems in
  1011.     /etc/fstab or by hand have changed, and some of the file
  1012.     systems have changed names.  To find out what the new options
  1013.     are, it's suggested that you read the manual page for the
  1014.     file systems' mount commands, for example mount_nfs(8) for
  1015.     NFS.  (Note that the information for mounts of type "ufs",
  1016.     i.e. Fast File Systems, are contained in the mount(8) man
  1017.     page.)
  1018.  
  1019.     Finally, you will want to delete old binaries that were part
  1020.     of the version of OpenBSD that you upgraded from and have since
  1021.     been removed from the OpenBSD distribution.  You might also
  1022.     want to recompile any locally-built binaries, to take
  1023.     advantage of the shared libraries.  (Note that any new
  1024.     binaries that you build will be dynamically linked, and
  1025.     therefore take advantage of the shared libraries, by default.
  1026.     For information on how to make statically linked binaries,
  1027.     see the cc(1) and ld(1) manual pages.)
  1028.  
  1029.  
  1030. Getting source code for your OpenBSD System:
  1031. --------------------------------------------
  1032.  
  1033. Now that your OpenBSD system is up and running, you probably want to get
  1034. access to source code so that you can recompile pieces of the system.
  1035.  
  1036. A few methods are provided.  If you have an OpenBSD CD, the source code
  1037. is provided.  Otherwise, you can get the pieces over the Internet using
  1038. ANONCVS, CTM or FTP.  For more information, see
  1039.  
  1040.     http://www.openbsd.org/anoncvs.html
  1041.     http://www.openbsd.org/ctm.html
  1042.     http://www.openbsd.org/ftp.html
  1043.  
  1044. Using online OpenBSD documentation:
  1045. -----------------------------------
  1046.  
  1047. Documentation is available if you first install the manual
  1048. distribution set.  Traditionally, the UN*X "man pages" (documentation)
  1049. are denoted by 'name(section)'.  Some examples of this are
  1050.  
  1051.     intro(1),
  1052.     man(1),
  1053.     apropos(1),
  1054.     passwd(1), and
  1055.     passwd(5).
  1056.  
  1057. The section numbers group the topics into several categories, but three
  1058. are of primary interest:  user commands are in section 1, file formats
  1059. are in section 5, and administrative information is in section 8.
  1060.  
  1061. The 'man' command is used to view the documentation on a topic, and is
  1062. started by entering 'man [section] topic'.  The brackets [] around the
  1063. section should not be entered, but rather indicate that the section is
  1064. optional.  If you don't ask for a particular section, the topic with the
  1065. least-numbered section name will be displayed.  For instance, after
  1066. logging in, enter 
  1067.  
  1068.     man passwd
  1069.  
  1070. to read the documentation for passwd(1).  To view the documentation for
  1071. passwd(5), enter
  1072.  
  1073.     man 5 passwd
  1074.  
  1075. instead.
  1076.  
  1077. If you are unsure of what man page you are looking for, enter
  1078.  
  1079.     apropos subject-word
  1080.  
  1081. where "subject-word" is your topic of interest; a list of possibly 
  1082. related man pages will be displayed.
  1083.  
  1084.  
  1085. Administrivia:
  1086. --------------
  1087.  
  1088. There are various mailing lists available via the mailing list
  1089. server at <majordomo@OpenBSD.ORG>.  To get help on using the mailing
  1090. list server, send mail to that address with an empty body, and it will
  1091. reply with instructions.  There are also two OpenBSD Usenet newsgroups,
  1092. comp.unix.bsd.openbsd.announce for important announcements and
  1093. comp.unix.bsd.openbsd.misc for general OpenBSD discussion.
  1094.  
  1095. To report bugs, use the 'sendbug' command shipped with OpenBSD,
  1096. and fill in as much information about the problem as you can.  Good
  1097. bug reports include lots of details.  Additionally, bug reports can
  1098. be sent by mail to:
  1099.  
  1100.     bugs@OpenBSD.ORG
  1101.  
  1102. Use of 'sendbug' is encouraged, however, because bugs reported with it
  1103. are entered into the OpenBSD bugs database, and thus can't slip through
  1104. the cracks.
  1105.  
  1106. As a favor, please avoid mailing huge documents or files to the
  1107. mailing lists.  Instead, put the material you would have sent up
  1108. for FTP somewhere, then mail the appropriate list about it, or, if
  1109. you'd rather not do that, mail the list saying you'll send the data
  1110. to those who want it.
  1111.